Definition info:

Create a file with ".cdata" as its extension. Add definitions described in CharacterFileData. The character might be chosen when a new game is started.

  • i:
    • Has to be a unique identifier.
  • n:
    • Names are only relevant if they are not overwritten by another mod like "Random Names".
  • x:
    • Add NSFW definitions if the character is inherently sexual.
  • r:
    • If the character is not original (from an existing franchise) add a restrictor:
      • Add "r={character name}"
    • If a restrictor is used all images for this character need to have the same restrictor.
    • Restrictors are used to decrease the amount of images that are checked during Image Search. This means they're optional, but generally should be used.
  • t:
    • "t" has 3 variations "ts" (or just "t"), "tr" and "ta". See Image Definitions.
    • If the character is not original (from an existing franchise) add these tags and replace their value:
      • Add "tr=character={character name}"
      • Add "tr=franchise={franchise}"
  • f:
    • Features are like tags that can change.
    • Add a gender feature with a "+":
      • Add "f=gender=+male" or "f=gender=+female"
    • If the player is original add other features, for example:
      • Add "f=hair color=black"
      • Add "f=hair length=short"
    • If the value is "random" a random feature (defined in a FeatureFileData) is chosen:
      • "f=hair color=random"
  • %:
    • This value determines the likelihood of the character chosen.
    • Can be ignored most of the time.
    • Can be useful for debugging, setting this to a high number (1,000,000) almost guarantees the character to be chosen.
  • c:
    • Determines how often the character can be chosen when a new game is created.
    • If not set manually this is set to be 1.
    • If set to "filler" this character is only chosen if no none filler characters are remaining.

Images:

A character needs predefined images or else a random image is chosen. The images require:

  • Restrictor (if the character has one)
  • All tags (for example: "t=character={character name}")
  • All features as tags (for example: t=hair color=black)

Examples:

Specific character:

i=base_character_nier_2b
n=2b
r=2b
f=gender=+female
tr=character=2b
tr=franchise=nier
end

Filler character:

i=base_character_random_female
n=Random Female
c=filler
f=gender=+female
f=hair length=random
f=hair color=random
end